---
title: 문제 해결
description: Learn how to troubleshoot issues with the OpenAI Agents SDK.
---

## 지원 환경

OpenAI Agents SDK는 다음 서버 환경에서 지원됩니다:

- Node.js 22+
- Deno 2.35+
- Bun 1.2.5+

### 제한적 지원

- **Cloudflare Workers**: Agents SDK는 Cloudflare Workers에서 사용할 수 있지만, 현재 다음과 같은 제한이 있습니다:
  - SDK는 현재 `nodejs_compat` 활성화가 필요함
  - 요청 종료 시 트레이스를 수동으로 플러시해야 함. 자세한 내용은 [트레이싱](/openai-agents-js/ko/guides/tracing#export-loop-lifecycle)을 참고하세요
  - Cloudflare Workers의 `AsyncLocalStorage` 제한적 지원으로 인해 일부 트레이스가 정확하지 않을 수 있음
  - 아웃바운드 WebSocket 연결은 fetch 기반 업그레이드를 사용해야 함(전역 `WebSocket` 생성자 사용 불가). Realtime의 경우 `@openai/agents-extensions`의 Cloudflare 전송(`CloudflareRealtimeTransportLayer`)을 사용하세요
- **브라우저**:
  - 브라우저에서는 현재 트레이싱을 지원하지 않음
- **v8 isolates**:
  - 적절한 브라우저 폴리필을 포함한 번들러를 사용하면 v8 isolates용으로 SDK 번들이 가능하나, 트레이싱은 작동하지 않음
  - v8 isolates는 광범위하게 테스트되지 않음

## 디버그 로깅

SDK 사용 중 문제가 발생하면 디버그 로깅을 활성화해 동작 상황을 더 자세히 확인할 수 있습니다.

`DEBUG` 환경 변수를 `openai-agents:*`로 설정해 디버그 로깅을 활성화하세요.

```bash
DEBUG=openai-agents:*
```

또는 SDK의 특정 부분에 대해서만 디버깅 범위를 지정할 수 있습니다:

- `openai-agents:core` — SDK의 주요 실행 로직
- `openai-agents:openai` — OpenAI API 호출
- `openai-agents:realtime` — Realtime Agents 구성 요소
